BBS Toolkit

home *** CD-ROM | disk | FTP | other *** search

/ BBS Toolkit / BBS Toolkit.iso / wildcat / chkmail.zip / CHKMAIL.DOC next >

Wrap

Text File | 1992-05-19 | 11.4 KB | 200 lines

╔═════════════════════════════════════════════════════════════════════════════╗ ║ CheckMail for WildCat 3.0 - Version 1.03 ║ ║ Copyright (c) 1992, Computer Discount Center, Ltd. ║ ╚═════════════════════════════════════════════════════════════════════════════╝ This program was created out of a need to avoid running the SCAN option of WildMail if no messages were entered by the BBS user. The command format is as follows: CHKMAIL [node] [/ANY] To use this utility, simply put CHKMAIL.EXE into the batch file that runs your bulletin board. Have the batch file run CHKMAIL.EXE immediately after the WildCat program exits. If the [node] parameter is included, CheckMail will check to see if the last user entered mail in the specified node, and/or if the user called the TomCat Mail Door. The main reason to run the utility is to greatly improve the speed of your system by only running the WM SCAN option if a user entered mail into the message bases. The "/ANY" switch can be used to indicate whether only netmail and echomail conferences should be checked, or whether "any" conferences including local BBS conferences should be checked. The program sets the DOS errorlevel to indicate whether you should run the WM SCAN program as follows: Errorlevel 1 - Messages were entered - run WM SCAN Errorlevel 0 - No messages entered - no need to run WM SCAN A sample batch file snippet follows: . . . WILDCAT /B %1 %2 <-- Runs WildCat BBS CHKMAIL <-- Sets errorlevel if msg entered IF ERRORLEVEL 1 GOTO SCANMAIL <-- If mail entered, run WM SCAN IF ERRORLEVEL 0 GOTO BYPASS <-- If no mail entered, don't scan :SCANMAIL WM SCAN <-- Scan using WildMail :BYPASS GOTO FRONTDOOR <-- Return to Mailer . . . The CheckMail program works by examining the activity log to see whether any messages were entered in the last session. Be sure to put CHKMAIL.EXE in the same subdirectory as your ACTIVITY.xxx file. If you only want to watch for messages in echo mail and netmail, put a copy of your AREAS.BBS and WM.CFG files there too. If you want to use CheckMail on other nodes, put the node number immediately following the CHKMAIL command. Example for node 2: CHKMAIL 2 If the activity log cannot be found in the current subdirectory, the program exits with the error message: "The activity log ACTIVITY.xxx could not be found." As the program runs, a number of status messages may appear on the screen: "No new mail added to conferences ..." - This means that the program did not find where the last user entered any messages. Program will exit with ERRORLEVEL = 0. "Mail added to conference(s) ..." - This means that the program determined that the last user did enter a message into at least one conference. This message appears if the /ANY switch is used and a message is entered into any conference. Program will exit with ERRORLEVEL = 1. "EchoMail added to conference(s) ..." - This means that the program determined that the last user did enter a message into at least one echomail conference. This message appears if the /ANY switch is omitted and the user enters a message into echomail. Program will exit with ERRORLEVEL = 1. "NetMail added to conference(s) ..." - This means that the program determined that the last user did enter a message into the NETMAIL conference. This message appears if the /ANY switch is omitted and the user enters a message into netmail. Program will exit with ERRORLEVEL = 1. "Mail Door Was Executed ..." - This means that the program determined that the last user called upon the TomCat Mail Door. Even if the user did not upload a reply, the program will still exit with ERRORLEVEL = 1, because TomCat does not indicate what happened inside the door within the activity log entry. "Event Log Activity Was Ignored ..." - This means that while processing the activity log, the program found that a Wildcat soft event occurred between the time the user logged off, and the time the CheckMail utility was run. The program will ignore the event entry, and scan backward until it finds the last user login entry. Program will continue to execute normally. The current version of CheckMail is version 1.03. This newest release of CheckMail will detect when the TomCat Mail Door was called by your user. Note that the program will set the ERRORLEVEL to 1 WHENEVER TomCat is called upon by the user, regardless of whether the user uploaded replies or downloaded messages. This is because TomCat does not log what the user did while in the mail door. The program also will now by default only check conferences described as "echomail" or "netmail". This can be turned off with the /ANY switch. To determine which conferences are echomail or netmail, the program will examine the AREAS.BBS file and WM.CFG file used by the Online Computer Resources WILDMAIL 2.0 mail tossing program. If you are using other networks other than Fido, or using a non-standard echomail system, then using the /ANY switch will make the program watch for any type of message and act accordingly. *** NOTE: The AREAS.BBS file and WM.CFG file MUST reside in the same directory as the CHKMAIL.EXE file ! Also, in earlier releases of the program, if Wildcat executed an event such as the No Node Page event, which was executed as a "soft" event after a user logged off, the program would see the entry from the event as a separate log on. This has been fixed in version 1.02 by causing the program to ignore the event entry in the activity log. ╔═════════════════════════════════════════════════════════════════════════════╗ ║ * * * Modification List * * * ║ ╟─────────────────────────────────────────────────────────────────────────────╢ ║ ║ ║ Version 1.00 - Introduced CheckMail For Wildcat 3.0. ║ ║ ║ ║ Version 1.01 - Provided Greatly Improved Speed for Mail Checking. ║ ║ ║ ║ Version 1.02 - Provided Support For TomCat Mail Door, and for ║ ║ ignoring Activity Log entries created by the ║ ║ Wildcat Event Handler. ║ ║ ║ ║ Version 1.03 - Provided the ability to only set the errorlevel for ║ ║ echomail or netmail conferences, so that Wildmail does ║ ║ not have to be run if the user enters a message into ║ ║ a conference that is local to the BBS only. ║ ║ ║ ╚═════════════════════════════════════════════════════════════════════════════╝ ** END OF CHKMAIL.DOC ** ╔═════════════════════════════════════════════════════════════════════════════╗ ║ This program is SHAREWARE. Please feel free to copy and distribute this ║ ║ but DO NOT modify it in any way. Computer Discount Center, Ltd. will ║ ║ not be liable for any loss resulting from the use of this program. ║ ║ ║ ║ ┌──────────────────────────────────────────────┐ ║ ║ │ * * * Registration is only $5.00 * * * │ ║ ║ │ │ ║ ║ │ To register by phone, have your Visa │ ║ ║ │ MasterCard, or Discover card ready, │ ║ ║ │ and call (904) 823-9669. │ ║ ║ │ │ ║ ║ │ * OR * │ ║ ║ │ │ ║ ║ │ Please make checks payable to: │ ║ ║ │ Computer Discount Center, Ltd. │ ║ ║ │ and mail to address below: │ ║ ║ └──────────────────────────────────────────────┘ ║ ║ Please leave your comments and suggestions to: ║ ║ ║ ║ Computer Discount Center, Ltd. ║ ║ 1260-B North Ponce de Leon Blvd. ║ ║ St. Augustine, FL 32084 ║ ║ (904) 823-9669 ║ ║ ║ ║ or you may leave Netmail to 1:3620/13, attention Jerry Ray. ║ ║ Thank you for supporting the shareware concept. ║ ╚═════════════════════════════════════════════════════════════════════════════╝ WildMail and WM is a trademark of Online Computer Resources. WildCat is a trademark of Mustang Software.